home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / FORTRAN / 1888.ZIP / README < prev   
Text File  |  1989-04-15  |  13KB  |  308 lines
  1.  
  2.  
  3.                 Getting Started with FAT-Video 1.30
  4.                 -----------------------------------
  5.  
  6.         Notice:
  7.         -------
  8.            This software is shareware, if you use it , please
  9.         honor that fact. Details regarding registration for this
  10.         product are enclosed in this "readme" file.
  11.  
  12.            This package provides several libraries of functions designed
  13.         for use with Microsoft Fortran, Lahey Fortran F77L, and
  14.         Lahey Personal Fortran LP77.
  15.  
  16.            FAT-Video does not support the IBM Professional Fortran,
  17.         nor does it support the Ryan-McFarland Fortran compiler.
  18.  
  19.            The libraries provide video/screen/keyboard/memory and
  20.         text windowing/menuing functions.
  21.  
  22.            Starting with FAT-Video 1.30 automatic support for TopView
  23.         windowing environments is included.  This allows you to write
  24.         Fortran windowing programs that are compatable with MS-WINDOWS,
  25.         DESQview, TOPVIEW, and GEM.
  26.  
  27.            There is a demo to demonstrate some of the
  28.         capabilities provided by the libraries. It works with a
  29.         Mono, CGA, EGA, or VGA adapter in modes 7 or 3(text modes).
  30.  
  31.           I've tested it with the ATI Graphics solution and the
  32.         ATI Wonder card, the IBM EGA, CGA and Mono cards, the
  33.         the Compaq Portable II graphics card, and a Paradise VGA card.
  34.  
  35.            If you have any trouble with your graphics card, let
  36.         me know your hardware configuration.
  37.  
  38.            There is also a manual on disk IN DOS format. To see how
  39.         to call each function from Fortran, see the manual regarding
  40.         that funtion.
  41.  
  42.         Installation on Hard Disk:
  43.         --------------------------
  44.         First copy the disk contents to an empty sub-directory
  45.         on your hard disk.
  46.         To extract files from the shareware archive file,
  47.         Type >arce fv130s
  48.  
  49.         Installation on Floppy Systems Only:
  50.         ------------------------------------
  51.         Same as above except you must specify an output path.
  52.         Type >arce fv130s b:\fatvid
  53.         Note: In the example you must first make the subdirectory
  54.         and name it fatvid on drive B:.
  55.  
  56.         Manual:
  57.         -------
  58.         The manual is on the shareware disk in generic DOS format.
  59.         Registered users receive a printed and bound 7"x9" version of
  60.         the manual.
  61.  
  62.         Demos:
  63.         -----
  64.         There are 2 demos, they are called Demo and Mview. Once unarchived
  65.         you need only type Demo/or Mview and the respective demo will start.
  66.         The source code for the DEMO and MVIEW is included with the registered
  67.         disk only.
  68.  
  69.  
  70.                         FAT-Video 1.30 Pricing Structure
  71.                         --------------------------------
  72.  
  73.  
  74.            The registered users of the FAT-Video package will receive
  75.         telephone support. The registered version includes the Fortran
  76.         source code for the window library, for your personal use and
  77.         modification. It may not be freely distributed. The registered
  78.         version also contains the window library for the Lahey Personal
  79.         Fortran compiler.
  80.  
  81.         Shareware Disk               $ 10.00    Manual on disk
  82.         Registration & Disk          $ 45.00    Manual and disk
  83.                                               & window Fortran source code
  84.         Assembler Source Code        $ 45.00    VIDEO library source code.
  85.         Upgrade (Reg users only)     $ 20.00    Manual and disk
  86.  
  87.         Shipping:
  88.         All Orders must add $5.00 for Standard UPS
  89.                          or 10.00 for UPS BLUE (2nd Day Air),
  90.         Maryland residents add 5% sales tax.
  91.  
  92.         For Info, or Purchase Orders, call 301-498-3782
  93.         To order, send check or mony order, and state items desired, to:
  94.  
  95.                 Marc A. Norton    -or-     Marc Norton
  96.                 P.O. Box 425               8254 Stone Trail Ct.
  97.                 Greenbelt MD  20770        Laurel, MD, 2070
  98.  
  99.                FAT-Video 1.30 Notes     January 1989
  100.                =====================================
  101.  
  102.           This document explains any last minute changes to FAT-Video,
  103.      and corrections for known errors in the manual.  Any information
  104.      included in this document supersedes information and instructions
  105.      contained in the users manual.
  106.  
  107.      I) Compiler Support:
  108.      --------------------
  109.         FAT-Video 1.30 fully supports the Lahey F77L compiler, and
  110.      Lahey Personal Fortran LP77.  There is no longer any need to use
  111.      the MSEXTERNAL keyword in Lahey Fortran programs.  The Video library
  112.      VIDEOLF.LIB was written for the F77L and LP77 compilers, and works
  113.      with both of these compilers.  The libraries WINLF.LIB and WINLFFS.LIB
  114.      should be used with the F77L compiler. The library WINLP.LIB should
  115.      be used with the LP77 compiler.
  116.  
  117.         The F77L compiler should use the WINLF.LIB library, unless you use
  118.      the "Fixed-Stack" memory model, as described in the manual. If you do
  119.      use the "Fixed-Stack" model use WINLFFS.LIB.  This topic is discussed
  120.      in the manual in the section "Using Lahey Fortran with FAT-Video".
  121.      The "Fixed-Stack" model is also discussed in the Lahey Manual.
  122.  
  123.         Note that the Lahey Personal Compiler does not support the "Fixed-
  124.      Stack" memory model and can only be linked with WINLP.LIB.
  125.  
  126.         Independent of which of the window libraries you use, both F77L and
  127.      LP77 should also be linked with VIDEOLF.LIB. An example Link command is
  128.      shown below.
  129.  
  130.      For F77L:  F77L MYPGM
  131.                 Link MYPGM,,,VIDEOLF WINLF;
  132.  
  133.        -OR-     F77L MYPGM
  134.                 Link MYPGM F77LFS,,,VIDEOLF WINLFFS;
  135.  
  136.      For LP77:  LP77 MYPGM
  137.                 Link MYPGM,,,VIDEOLF WINLP;
  138.  
  139.      II) Library Names:
  140.      ------------------
  141.           The names of all of the libraries have been changed to clarify
  142.      the use of each library.  Three new libraries have been added to the
  143.      FAT-Video package. The manual uses the old library names, you should
  144.      use the new library names. The old and new library names are listed
  145.      below to help you decipher the manuals explanations. The compiler
  146.      that should be used with each library is also listed.
  147.  
  148.      OLD LIBRARY NAMES       NEW LIBRARY NAMES    SUPPORTED COMPILER
  149.      -----------------       -----------------    -------------------
  150.      VIDEO.LIB                VIDEOMF.LIB         Microsoft Fortran
  151.      WINDOWM.LIB              WINMF.LIB           Microsoft Fortran
  152.      N/A                      VIDEOLF.LIB         Lahey F77L & LP77
  153.      WINDOWL.LIB              WINLF.LIB           Lahey F77L "Heap"
  154.      N/A                      WINLFFS.LIB         Lahey F77L "Fixed-Stack"
  155.      N/A                      WINLP.LIB           Lahey LP77
  156.  
  157.  
  158.      III) Library Compiler Settings
  159.      -------------------------------
  160.           Any special information regarding compiler settings used when
  161.      the FAT-Video window libraries were built is given below. Only settings
  162.      which could affect how you use these libraries is given.
  163.  
  164.      A)   WINMF.LIB - All subroutines in this window library were compiled
  165.           using the following command:
  166.  
  167.           FL /c /Fc /4Nt
  168.  
  169.      B)   WINLF.LIB & WINLFFS.LIB - All subroutines in these libraries
  170.           were compiled with F77L 3.0 using floating point emulation,
  171.           no SLD information, and no remembering of subroutine variables.
  172.  
  173.      C)   WINLP.LIB - All subroutines in this library were compiled with
  174.           LP77 2.0 using floating point emulation. These subroutines do
  175.           contain SLD debugging information, since the compiler automat-
  176.           ically puts it in the object modules.
  177.  
  178.      IV) Corrections To The Manual
  179.      ------------------------------
  180.        A) Function Desriptions
  181.        --------------------
  182.           1) pg 24 VSOUTP(STRING)
  183.                 should be:
  184.              VSOUTP(STRING,ROW,COL)
  185.  
  186.           2) pg 26 VSGVB(OFFSEG)
  187.                  should be:
  188.              VSGVB(OFF,SEG)
  189.  
  190.           3) pg 62 MSGA
  191.              KEYVALS should be defined as an array:
  192.              INTEGER*2 NVALS,KEYVALS(NVALS)
  193.  
  194.           4) VSGEGA was left out of the manual, its description follows:
  195.  
  196.              SUBROUTINE VSGEGA(FLAG)
  197.              INTEGER*2 FLAG
  198.  
  199.              Subroutine VSGEGA returns the EGA status. If FLAG=0 no EGA
  200.              card was detected. If FLAG=1 an EGA card was detected by INITFV.
  201.  
  202.           5) pg 37 PBV and LPBV
  203.  
  204.              a) Microsoft Fortran:
  205.                    PBV may be called from Microsoft Fortran as described in
  206.                 the manual. LPBV should not be called from Microsoft Fortran.
  207.  
  208.              b) Lahey Fortran F77L & LP77
  209.                    LBPV and PBV are identical in the VIDEOLF.LIB library.
  210.                 The may both be called from F77L or LP77. The description
  211.                 in the manual for LBPV is the correct description to use
  212.                 for both LPBV and PBV when using VIDEOLF.LIB and a Lahey
  213.                 compiler.  The duplicate function of these subroutines is
  214.                 redundant, but makes porting between Lahey and Microsoft
  215.                 Fortran much easier. The explanation in the Manual is correct
  216.                 if you use VIDEOMF.LIB and MSXETERNAL.
  217.  
  218.      VI)  Recompileing The Window Library Source Code
  219.      -------------------------------------------------
  220.          Some of the Fortran source code generates non-fatal error
  221.      messages, they can be ignored.
  222.  
  223.          A) Microsoft Fortran
  224.  
  225.                The Microsoft window library archive, FV130MF.ARC, contains
  226.             2 .BAT files, MSLIB.BAT and MAKLIB.BAT. These files compile the
  227.             individual source files for the window library, and form the
  228.             library from the compiled source code.  These .BAT files
  229.             should make recompileing the source code much simpler.
  230.                To use them, at the DOS prompt enter:
  231.  
  232.                C:>MSLIB<RETURN>
  233.                C:>MAKLIB<RETURN>
  234.  
  235.                You must have the Microsoft Fortran compiler and library
  236.             manager in your current path.
  237.  
  238.          B)  Lahey Fortran
  239.  
  240.                The Lahey window library archive, FV130LF.ARC, contains
  241.              5 .BAT files, LFLIB.BAT, LPLIB.BAT, MAKLIBLF.BAT, MAKLIBFS.BAT,
  242.              and MAKLIBLP.
  243.                LFLIB.BAT compiles the window source code using F77L and
  244.              MAKLIBLF.BAT makes the library WINLF.LIB.  LPLIB.BAT compiles
  245.              the window source code using LP77 and MAKLIBLP.BAT forms the
  246.              library WINLP.LIB.  Once WINLF.LIB is formed you can use
  247.              MAKLIBFS.BAT to make the "Fixed-Stack" library, WINLFFS,
  248.              for F77L.
  249.                Take notice of the size of the LP77 library. It is larger
  250.              than the F77L library because LP77 always puts debugging info
  251.              in its .OBJ modules. The F77L library WINLF is smaller than
  252.              WINLP.LIB because no debugging information was placed in the
  253.              WINLF library. If you want libraries with the SLD debugging
  254.              information, you must recompile the source code in the
  255.              FV130LF.ARC file.
  256.                 Before you recompile any source code you must place a dummy
  257.              file call LAHEY.INC in the directory you will be compiling
  258.              from.  The file LAHEY.INC is required because the INCLUDE
  259.              LAHEY.INC statement was left in the window source code.  The
  260.              dummy LAHEY.INC file may contain a single line and it may be a
  261.              comment line, such as:
  262.  
  263.                     C......dummy include file......
  264.  
  265.                 Using this dummy include file will also allow you to recompile
  266.              any previous code you've written without editing any source code.
  267.  
  268.                 Remember, any code you've compiled with Lahey Fortran previous
  269.              to FAT-Video 1.30, with the INCLUDE LAHEY.INC, must be recompiled
  270.              before linking with VIDEOLF.LIB.
  271.  
  272.  
  273.      VII) Demos & Sample Programs
  274.      ----------------------------
  275.  
  276.           All demonstration and sample software is included in an archive
  277.      file on the disk.  This software is provided in an as is condition,
  278.      it is intended as a source of examples. Some of these programs generate
  279.      non-fatal errors, you can ignore them.  DEMOL & MVIEWL/MIEWXL have been
  280.      compiled, linked, and run using the Lahey compilers F77L 3.00 & LP77 2.0.
  281.      DEMO & MVIEW/MVIEWX have been compiled, linked, and run using the Microsoft
  282.      Fortran 4.1 compiler.  The archive file names and  their contents are
  283.      listed below:
  284.  
  285.           A) Microsoft Disk
  286.  
  287.              SAMPMF.ARC - contains:
  288.              ----------
  289.              DEMO.FFR
  290.              MVIEW.FFR, MVIEWX.FFR
  291.              SAMPLxx.FFR
  292.  
  293.           B) Lahey Disk
  294.  
  295.              SAMPLF.ARC -contains:
  296.              ----------
  297.              DEMOL.FFR
  298.              MVIEWL.FFR, MVIEWL.FFR
  299.              SAMPLxx.FFR
  300.  
  301.      FURTHER HELP & INQUIRIES:
  302.      =========================
  303.  
  304.      Contact: Marc A Norton
  305.               8254 Stone Trail Ct
  306.               Laurel, MD, 20707
  307.               301-498-3782
  308.